When calling the MPAllocateAligned
function, you can specify optional actions by passing a constant of type OptionBits
in the options
parameter.
enum {
/* Values for the options parameter to MPAllocateAligned.*/
kMPAllocateClearMask = 0x0001,
kMPAllocateGloballyMask = 0x0002,
kMPAllocateResidentMask = 0x0004,
kMPAllocateNoGrowthMask = 0x0010
};
Constant Descriptions
kMPAllocateClearMask
Zero out the allocated memory block.
kMPAllocateGloballyMask
Allocate memory from in memory space that is visible to all processes. Note that such globally-allocated space is not automatically reclaimed when the allocating process terminates. By default, MPAllocateAligned
allocates memory from process-specific (that is, not global) memory.
kMPAllocateResidentMask
Allocate memory from resident memory only (that is, the allocated memory is not pageable).
kMPAllocateNoGrowthMask
Do not attempt to grow the pool of available memory. Specifying this option is useful, as attempting to grow memory may cause your task to block until such memory becomes available.